home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-02 / prodpack.zip / README < prev    next >
Text File  |  1993-05-26  |  14KB  |  353 lines
  1.                  Welcome to the dBASE IV Productivity Pack(R)
  2.                          for dBASE IV version 2.0
  3.  
  4.                 Copyright (c) 1993 Borland International, Inc.
  5.  
  6. Borland(R) grants you permission to use, modify, reproduce and
  7. distribute this dBASE IV Productivity Pack as a part of programs
  8. or applications you write, without additional license or fees,
  9. subject to the following conditions:
  10.  
  11.   *   All copies of your program or application must bear a valid 
  12.       copyright notice.  By "copyright notice," we mean either your
  13.       own copyright notice or the Borland copyright notice shown
  14.       above.
  15.  
  16.   *   Borland provides no warranties or guarantees with respect to
  17.       the dBASE IV Productivity Pack.  Borland provides this software as 
  18.       is.
  19.  
  20.   *   You will remain solely responsible to anyone receiving the 
  21.       program or application for any support, service, upgrades or
  22.       technical or other assistance, and such recipients will have no
  23.       right to contact Borland for such services or assistance.  You
  24.       will indemnify and hold Borland harmless from and against any
  25.       claims or liabilities arising out of the use, reproduction or
  26.       distribution of the Dialog Box builder.
  27.  
  28.   *   Your program or application may not merely be the Dialog Box
  29.       Builder itself or a competitive product.
  30.  
  31. All Rights Reserved.  All Borland products are trademarks or
  32. registered trademarks of Borland International, Inc.  Other brand and
  33. product names are trademarks or registered trademarks of their
  34. respective holders.
  35.  
  36. This file contains important information about the dBASE IV Productivity 
  37. Pack, including installation and getting it started.
  38.  
  39. TABLE OF CONTENTS
  40. -----------------
  41. 1. Communicating with Borland
  42. 2. Minimum System Requirements
  43. 3. Installation
  44. 4. Getting Started
  45. 5. The On-Line Help System and Documentation
  46. 6. dBEdit - A Modify Command Alternative
  47. 7. BDCDrive - A Front-end to the dBASE Compiler
  48.  
  49. 1. COMMUNICATING WITH BORLAND
  50.  
  51. If you have any questions or wish to share ideas with us at Borland,
  52. you can use the Template section 7 on the Borland dBASE Forum on
  53. CompuServe.  If updates becomes available we will post them on the
  54. Template section.  If you do not have access to CompuServe, you may
  55. send your comments to:
  56.  
  57.     Bill Ramos
  58.     Senior Engineer, dBASE for DOS Development
  59.     Borland International Inc.
  60.     1800 Green Hills Road
  61.     Scotts Valley, CA, 95067
  62.  
  63.     or 
  64.     MCI Mail: BRAMOS
  65.     CIS:      72110,2563
  66.  
  67. Please do not call Borland Technical Support.
  68.  
  69. The dBASE IV Productivity Pack is also available to members of the dBASE 
  70. Developer Partners Program at no additional charge.  For more information 
  71. regarding this program, please call 1-800-331-0877.
  72.  
  73. As an experienced developer you can study the code in the programs
  74. and templates and learn how to add new power to your programs.  We
  75. encourage you to use this tool and to try enhancing it yourself.  As
  76. you create innovative new design tools and features, let us know, we
  77. may want to publish your work next!
  78.  
  79.  
  80. 2. MINIMUM SYSTEM REQUIREMENTS
  81.  
  82. The following are the minimum system requirements for Dialog Box
  83. Builder:
  84.  
  85.   *   dBASE IV(R) version 2.0 installed
  86.   *   3 MB of Free Extended Memory (for reasonable performance)
  87.   *   BDCDrive.EXE requires 500k of available low DOS memory
  88.  
  89.  
  90. 3. INSTALLATION
  91.  
  92. To install dBASE IV Productivity Pack, do the following:
  93.  
  94.   *   Insert Disk 1 of 1 into your 3.5-inch disk drive
  95.  
  96.   *   Type in the letter of the drive followed by a colon.  For example,
  97.       If your 3.5-inch disk drive is your A: drive, type:
  98.  
  99.          A:
  100.  
  101.       followed by the Enter key.
  102.  
  103.   *   Type in the following DOS command:
  104.  
  105.          DBASE INSTALL
  106.  
  107.       This command assumes that dBASE IV version 2.0 is in your DOS path.
  108.       Please review this README. file after the installation is complete.
  109.  
  110. The installation program does the following:
  111.  
  112.   *   Creates DBB.BAT and CONFIG.DBB in your dBASE home directory.
  113.  
  114.   *   Copies DBBDSGN.DBO, DBBLIB.DBO, DBEDIT.EXE, and SCR2DBF.GEN into
  115.       your dBASE directory.  If also copies the DBBHELP.* help system 
  116.       files and the DLGHELP.* empty help files into your dBASE directory.
  117.  
  118.   *   Copies BDCDrive.EXE and its BDCDRIVE.* help files into your dBASE
  119.       directory.
  120.  
  121.   *   Copies the sample files into a subdirectory named DB4PPSAM off
  122.       of your dBASE home directory.
  123.  
  124.   *   Copies the source files into a subdirectory named DB4PPSRC off
  125.       of your dBASE home directory.  You will also find 
  126.       DBB.MAK used to create DBBDSGN.DBO, DBBLIB.DBO, and SCR2DBF.GEN.  
  127.       This allows you to use the MAKE.EXE program that comes with the 
  128.       dBASE Compiler or other Borland language products to make your own 
  129.       enhancements to dBASE IV Productivity Pack.
  130.  
  131.  
  132. 4.  GETTING STARTED
  133.  
  134. To test drive the Dialog Box Builder portion of the dBASE IV Productivity 
  135. Pack, do the following:
  136.  
  137.   *   Go to the DB4PPSAM directory under your dBASE home directory.  For
  138.       example, if your dBASE is installed at C:\DBASE, type:
  139.  
  140.          CD \DBASE\DB4PPSAM
  141.  
  142.   *   Start dBASE using the DBB.BAT file by typing:
  143.  
  144.          DBB
  145.  
  146.   *   To run the TVDIAL dialog box sample, select the TVDIAL item from
  147.       the Forms Panel.  Press the Escape key to exit the dialog box.
  148.  
  149.   *   To review the layout for the TVDIAL dialog box, highlight the
  150.       TVDIAL item in the Forms Panel and press Shift-F2 Design.
  151.  
  152.  
  153. The Dialog Box Builder is hooked into dBASE using the Open Architecture 
  154. of the Control Center feature.  This means that you access the design 
  155. features using the "Invoke layout program" menu item from the
  156. "Layout" menu in the Control Center Forms Designer.  There is also a
  157. dialog box to control code generation off of the "Open custom
  158. utility" menu item from the "Catalog" menu.
  159.  
  160.  
  161. 5. THE ON-LINE HELP SYSTEM AND DOCUMENTATION
  162.  
  163. The documentation for dBASE IV Productivity Pack is contained in its help
  164. system data files.  This file is named DBBHELP.DBF.  Dialog Box
  165. Builder comes with a report form named DBBHELP.FRM.  You can use this
  166. report form to print out the help system.  To print the help file
  167. from the DOT prompt, type in the following commands while in your
  168. dBASE home directory.
  169.  
  170.   *   USE DBBHelp ORDER File_Name
  171.  
  172.   *   REPORT FORM DBBHelp TO PRINTER
  173.  
  174. To see the help system in action, do the following steps starting at
  175. the DOT prompt:
  176.  
  177.   *   Press F2 for ASSIST
  178.  
  179.   *   Press Alt-C O to open custom utility.  This brings up the
  180.       dBASE IV Productivity Pack's options dialog.
  181.  
  182.   *   Press F1 for Help on the Developer mode check box item.
  183.  
  184.   *   After reading the help frame, press C for the Contents.  This
  185.       displays the items that you can receive help on for this dialog
  186.       box.
  187.  
  188.   *   Press Ctrl-PgUp for the global table of contents.  This
  189.       provides you a table of contents for all the help in Dialog Box
  190.       Builder.  Stay in the main menu for now.
  191.  
  192.   *   Type in the work "Common", this will take you to the Common
  193.       Questions help topic.  Press the Enter key to select this
  194.       category.  Go ahead and browse through the various help
  195.       categories and topic.  When finished, press the Escape key.
  196.  
  197.  
  198. 6. DBEDIT - A MODIFY COMMAND ALTERNATIVE
  199.  
  200. dBEdit.EXE is text file editor created using Borland's C++ and Turbo
  201. Vision.  dBEdit allows you to edit multiple files at one time.  What
  202. makes dBEdit interesting is that it uses the active screen as its 
  203. background and can start-up within specified window coordinates.  After 
  204. installation, dBEdit.exe is placed in your dBASE home directory.
  205. This way, it will be available, assuming you have dBASE in your DOS
  206. path.
  207.  
  208. The following is the list of supported keyboard commands:
  209.  
  210. Command                         Main Keystroke            Alternate
  211. -----------------------------   -------------------       ---------
  212. Cursor movement commands
  213. Character left                  LeftArrow                 Ctrl+S
  214. Character right                 RightArrow                Ctrl+D
  215. Word left                       Ctrl+LeftArrow            Ctrl+A
  216. Word right                      Ctrl+RightArrow           Ctrl+F
  217. Line up                         UpArrow                   Ctrl+E
  218. Line down                       DownArrow                 Ctrl+X
  219. Page up                         PgUp                      Ctrl+R
  220. Page down                       PgDn                      Ctrl+C
  221. Beginning of line               Home
  222. End of line                     End
  223. Top of file                     Ctrl+PgUp
  224. Bottom of file                  Ctrl+PgDn
  225.  
  226. Insert and delete commands
  227. Delete character                Del
  228. Delete character to left        Backspace
  229. Delete line                     Ctrl+Y
  230. Delete to end of line           Ctrl+Q Y
  231. Delete word                     Ctrl+T
  232. Insert mode on/off              Ins
  233.  
  234. Block commands
  235. Set beginning of block          Ctrl+K B
  236. Delete block                    Ctrl+K Y
  237. Copy block                      Ctrl+K I
  238. Copy to Clopboard               Ctrl+Ins
  239. Cut to Clipboard                Shift+Del
  240. Delete block                    Ctrl+Del                  Ctrl+K K
  241. Paste from Clipboard            Shift+Ins
  242.  
  243. Extending selected blocks       
  244. Left one character              Shift+LeftArrow
  245. Right one character             Shift+RightArrow
  246. End of line                     Shift+End
  247. Beginning of line               Shift+Home
  248. Same column on next line        Shift+DownArrow
  249. Same column on previous line    Shift+UpArrow
  250. One page down                   Shift+PgDn
  251. One page up                     Shift+PgUp
  252. Left one word                   Shift+Ctrl+LeftArrow
  253. Right one word                  Shift+Ctrl+RightArrow
  254. End of file                     Shift+Ctrl+End
  255. Beginning of file               Shift+Ctrl+Home
  256.  
  257. Block Commands
  258.  
  259. A block of text is any amount of text, from a single character to 
  260. hundreds of lines, that is selected on your screen.  There can be 
  261. only one block in a window at a time.  Select a block with your mouse
  262. or by holding down Shift while moving your cursor to the end of the 
  263. block with the arrow keys.
  264.  
  265. When you choose Edit|Copy or press Ctrl+Ins, the selected block is
  266. copied to the Clipboard.  When you choose Edit|Paste or Shift+Ins,
  267. the block help in the Clipboard is inserted at the current cursor
  268. position.  The selected text remains unchanged and is no longer 
  269. selected.
  270.  
  271. If you choose Edit|Cut or press Shift+Del, the selected block is 
  272. moved from its original position and held in the Clipboard.  It is
  273. pasted at the current cursor position when you choose the Paste
  274. command.
  275.  
  276. Other Editing Commands
  277.  
  278. Options|AutoIndent toggles the automatic indenting of successive lines.
  279.  
  280. File|Open allows you to open an existing file for editing.  dBEdit uses
  281. the file extension of the file you started it with as the default file
  282. extension.
  283.  
  284. Exiting the dBEdit
  285.  
  286. Alt-X terminates the edit session and returns you to the calling program.
  287. dBEdit will also exit when you have closed all the active windows by 
  288. clicking on the window's close icon or by pressing Alt+F3.
  289.  
  290. dBEdit.EXE takes two parameters.  The first is a set of four values
  291. that represent window coordinates.  The second is the name of the
  292. file to edit.  If you do not specify the window coordinates, the
  293. editor will show a full size window.  If you do not specify a file
  294. name, the editor will use the name NONAME.PRG as a default.  For
  295. example, in config.db, you can specify an editor to use for MODIFY
  296. COMMAND with the TEDIT option.  Try adding this line to your
  297. config.db file:
  298.  
  299.   TEDIT = DBEDIT 5 5 19 75
  300.  
  301. The next time that you start-up dBASE and issue the command, MODIFY
  302. COMMAND, dBEdit will bring up your program file in a window.
  303.  
  304. dBEdit can support file sizes up to 64k.
  305.  
  306.  
  307. 7. BDCDRIVE - A FRONT-END TO THE DBASE COMPILER
  308.  
  309. BDCDrive.exe is a dBASE compiled program that you can use as a front-end 
  310. to the compiler.  The user interface for BDCDrive was created with the 
  311. Dialog Box Builder.  The following files are installed in the DB4PPSAM 
  312. directory:
  313.  
  314.    BDCDrive.PRG   - Main program
  315.    BDCOpt.SCR
  316.    BDCOpt.PRG     - Generated from BDCOpt.SCR
  317.    BDCLink.SCR
  318.    BDCLink.PRG    - Generated from BDCLink.SCR
  319.    BDLDrvr.PRG    - Driver program for BDCLink
  320.    BDCEdit.PRG    - UDF to call file editor
  321.    BDCFill.PRG    - UDF to update dialog box after editing .CFG file
  322.    BDCOk.PRG      - UDF to validate dialog box entries after selecting Ok
  323.    textdbf.bin    - Actually a .dbf file, see BDCEdit.prg
  324.    textdbt.bin    - Actually a .dbt file, see BDCEdit.prg
  325.    BDCDrive.lst   - A dBASE Compiler .lst file for compiling and linking
  326.                     BDCDrive.  This file assumes that DBBLIB.DBO is in
  327.                     the parent directory of DB4PPSAM.
  328.  
  329. The following files are placed in your dBASE home directory:
  330.  
  331.    BDCDrive.EXE   - Requires dBASE.RTL in your DOS path and is the
  332.                     compiled version of BDCDrive.prg
  333.    BDCDrive.dbf   - Help file for BDCDrive
  334.    BDCDrive.dbt   - Help file for BDCDrive
  335.    BDCDrive.mdx   - Help file for BDCDrive
  336.  
  337. If you wish to make modifications to BDCDrive, you can recompile 
  338. BDCDrive.prg as follows:
  339.  
  340.   *   Go to the DB4PPSAM directory under your dBASE home directory.
  341.  
  342.   *   Type in the following command at the DOS prompt:
  343.  
  344.          BDC @BDCDrive.lst
  345.  
  346.       This command compiles and links BDCDrive.exe
  347.  
  348.   *   Copy BDCDrive.exe back to your dBASE home directory.
  349.  
  350.  
  351.  
  352.  
  353.